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METHOD AND APPARATUS FOR GENERATING SERIALIZAT ION CODE 
VOR REPRESENTING A MODEL IN DIFFERENT TYPE SYSTEMS 

Abstract of the Disclosure 

5 

In Older to use object-oriented models over the Internet for applications in diiferent type systems it 
is necessary to marshal and unmarshal objects between Java» SQL and XML. Hand-writing specific 
code to do this is difficult. The present invention provides a computer-implemented method of 
generating serialization code for representing a model in a plurality of type systems, the method 
10 comprising the steps of: i) producing an input file from the model for a given set of objects; ii) 
providing a code generator for acting on the input file to generate the serialization code. 
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METHOD AND APPARATUS FOR GENERATING SERIALIZATION CODE 
FOR REPRESENTING A MODEL IN DIFFERENT TYPE SYSTEMS 

Technical Field 

The invention relates to the field of computer software for generating code, and more 
particularly to software for generating code for marshalling objects in a distributed computer 
network. 

Background Art 

Multi-tier architectures in computer software applications have become widespread due to 
the importance of the Internet environment, and particularly the World Wide Web, which commonly 
involves communication between a first subset of computers which are the source of information and 
documents, referred to herein as "servers", and a second subset of computers which request such 
information and documents fcom servers, referred to herein as "clients". The servers often must 
communicate with a database management system to obtain data. Thus there is typically a client tier, 
an ^plication tier including the application servw and a database tier including a database server. 
HTTP, SOAP, XML and Java are the commonly-used protocols and languages to provide reliable 
means ofconununication over the Internet. Different tiers often use different type systems. For 
example the database server will often use SQL while the application server might use Java and 
XML and a client may use Visual Basic or Java, 

Object oriented programming is widely used to facilitate the software development process. 
For example, various visual modelling software based on UML is available to assist software 
developers. Such tools allow programmers to build and describe a set of objects and relationships 
to model the business process of interest. 

Glossary 

The following terms have the following meanings well understood in the art: 
CA9-2000-0064 i 
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Binding information 

Information allowing the translation of names or structures used in one type system into the 
relevant names and structures used in another type system. 

Class 

A generalization used in programming languages to indicate a set of objects with common 
attributes (e.g. a Car class could be defined to generalize GM and Ford cars). Specific 
instances of a Class used in a program are called Objects. 

Formal description 

A carefully specified (in a mathematical or computational smse) description that is usually 
independent of any implementation or platform. 

Generated code 

Source code generated by a tool. 

Generic code 

Code able to handle a large variety of inputs by using some meta-data on those inputs. 
Graph 

A graph-in the sense used in graph theory-consists of nodes (also called points, or vortices) 
and of edges (lines) connecting certain pairs of nodes. The exact geometric pattern is not 
specified. In a directed graph (digraph) all edges are given a direction. 

HTTP 

Hypertext Transfer Protocol (HTTP) is the set of rules for exchanging files (text, graphic 
unages, sound, video, and other multimedia files) on the World Wide Web. 

Inheritance 
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In object oriented programming, inheritance is a way for a class to extend the behaviour of 
another class while adding or changing the original behaviour. The original class is called 
the base, super, parent or extended class. The class extending the other is called the derived 
or inherited or sub or child class. 

Java™ 

Java is a programming language expressly designed for use in the distributed environment 
of the Internet Java is a trademark of Sun Microsystems Inc. 

Marshalling - UnmarsbaUing 

The process of gathering (marshalling) data from a number of sources, placing the data into 
a buffer and organizing the data into a desired format. Unmarshalling is the opposite 
process. This is often also referred to as serialization/unserialization. 

Optimize 

Making the code better by reducing the time and resources needed to run the code. 
Primitive types 

In Object Oriented Programming these are types that are not Objects, such as int, float, 
double etc. 

Rational Rose^^ 

Visual (object oriented) modelling tool from Rational Software Corporation ("Rational 
Object Oriented Software Engineering") for software developers and architects. It uses UML 
as a modelling language to identify and organize the requirements and structure of an appli- 
cation and model business processes. 
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Reflection 

Getting meta-information about an object at runtime. 
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Relationship 

Relation between objects in a model. 
SOAP 

SOAP (Simple Object Access Protocol) is a way for a program running in one kind of 
operating system to communicate with a program in the same or another kind of an operating 
system by using the World Wide Web's Hypotext Transfer Protocol and its Extensible 
Maikup Language (XML) as the mechanisms for information exchange. 

SQL 

SQL (Structured Query Language) is a standard interactive and programming language for 
getting information fiom and updating a database. 

Type systems 

These include Java, C++. Visual Basic, XML, XMI, XSL, SQL and others. 
UML 

Unified Modelling Language ("UML") is a standard notation for the modelling of real-world 
objects. It is an evolution of early approaches to object-oriented analysis and design. 

XMI 

XML Metadata Interchange ("XMI") is a proposed standard syntax to allow the exchange 
of UML model meta-data using XML. 

XML 

Extensible Markup Language ("XML") is a standard language or syntax for describing 
hierarchical data (names and structure) designed for network communications in which 
markup symbols or tags enable the definition, rqjresentation, transmission, validation, and 
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interpretation of data between sending and receiving computers. An XML document (or 
collection of data) can confonm to a XML vocabulary definition (and be validated against it). 

XML Vocabulary 

5 A specific set of tags that constrain an XML documents data to have a particular set of 

names and structure. These are often defined in the context of a vertical industry (e.g. 
banking). 

XSL 

1 0 Extensible Stylesheet Language, formerly called Extensible Style Language, is a language 

for transforming XML documents, often used to transform them into web pages (HTML). 

Sending the data held in objects in a type system (e.g. Java) through HTTP using XML (as 
is done using SOAP) requires that the objects be first marshalled to XML and then on the other end. 

15 to be unmarshalled ft'om XML into new objects (in Java or another programming language). 
Information needed to build those Java objects is usually stored in a database or comes fit)m a legacy 
system. It is a common programming problem to need to convert between several type systems such 
as Java, XML or SQL and using various XML vocabularies. Although it might be possible to have 
generic code doing those tasks (if using Java with the reflection API (Application Program Interface) 

20 for instance), such code could not perform as well as specific code written for each object and 
usually does not poform well enough. Hand-writing specific code such as the one to do the 
marshalling and unmarshalling between Java and XML is a daunting task, error prone and difficult 
to maintain. 

2 5 Previous attempts at marshalling and unmarshalling Java objects to/fi-om XML as well as 

persisting and retrieving Java objects to/fi-om a database have been 
made. Examples are the following: 

Quick 1.2 : http://www.jxmlxom/index.html 
CA9-2000-0064 5 
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Exolab Castor 0.8.8 : http://castor.exolab.org/ 

Adelard : http://java.sun.cx>m/xmydocs^inding/DataBinding.html 

These methods all focus on the conversion from one type system to another and do not have 
the concept of using an object model. There is therefore a need for a system which solves the 
conversion between any number of type systems, provides a means to reuse an object model 
definition from a standard UML description (in XMI), provides a complete description of the model 
and the binding information in one simple XML foraiat, and supports inheritance at runtime. Note 
also that driving the system from a central type system independent model increases reuse and 
improves the scaling of the number of inter type system bindings that need to be specified (from 
order to order N where N is the number of type systems. 

Disclosure of Invcntioii 

The present invention solves the conversion between any number of type systems. In addition 
the mvention provides the definition of a complete description of the model (exported from a UML 
description) and the binding information in one simple XML format. The invention also supports 
inheritanceatruntimeand the useof graphs to create XML messages and optimizes database queries. 

The invention therefore provides a computer-implemented method of generating serialization 
code for representing a model in a plurality of type systems, the method comprising the steps of: i) 
producing an input file from the model for a given set of objects; ii) providing a code generator for 
acting on the input file to generate the serialization code. 

The invention fiirther provides a data processing system for generating serialization code for 
representing a model in a plurality of type systems, the data processing system comprising: i) means 
for producing an input file torn the model for a given set of objects; and ii) means for providing a 
code generator for acting on the input file to generate the serialization code. 
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The invention further provides a computer program product for generating serialization code 
for representing a model in a plurality of type systems, the computer program product comprising: 
a computer usable medium having computer readable program code means anbodied in the medium 
for producing an input file from the model for a given set of objects; and the compute usable 
medium having computer readable program code means embodied in the medium for providing a 
code generator for acting on the input file to generate the serialization code. 

The invention further provides an article comprising: a computer readable modulated carrier 
signal; means embedded in the signal for producing an input file from the model for a given set of 
objects; and means embedded in the signal for providing a code generator for acting on the input file 
to generate serialization code. 

Brief Description of Drawings 

In drawings which illustrate a preferred embodiment of the invention: 

Fig. 1 is a schematic diagram illustrating the invention; 

Fig. 2 is a flowchart illustrating code gmeration according to the invention; 

Fig. 3 is a flowchart illustrating in fiirther detail code generation according to the invention; 

and 

Fig. 4 is a schematic drawing of the files generated by the invention. 

Best Mode^s^ For Carrying Out the Invention 

With reference to Fig. 1, a model 10 has been created by a visual modelling tool such as 
Rational Rose. It comprises a number of objects defined in Unified Modelling Language. This 
model can be exported using XMI or XML Metadata Interchange, which is used to describe the 
UML model in the XML fonnat. The present invention provides bindings between the model 
description 10 and a number of types such as Java 12, SQL 14 and XML 16 (which may use 
different vocabularies such as SOAP, XMI or custom XML). The invention generates code which 
at run-time allows the conversion of the object from one type to another, for example marshalling 
and unmarshalling code to pack or unpack Java data objects into XML messages, or convert a Java 
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object into a relational SQL object or vice versa, or XML to SQL and back. This is done, as 
described as follows, in two steps: 1) the first step is to produce an input file for the given set of 
objects or model description 10 which is referred to as the XIDL or XML Interface Definition 
Language file; 2) then the generator is run to produce the Java code (or possibly C++ code) Aat 
5 allows the use of those objects and does all required type conversions (XML to Java, SQL to Java, 
XML to SQL, or possibly XML to C++, C++ to Java, etc.)- 

The present invention thus defines a binding between several type systems such as Java, 
XML (using arbitrary vocabularies) or SQL. It makes use of a type independent model description 

10 and meta-data such as the bindings (or links) to various type systems to generate all the code needed 
to use the objects fi-om the model in those type systems. Thus, one object fi-om the model can be 
used as a Java object, as a XML object or as a relational object stored in one table. The code that 
handles conversion of objects fi-om one type to another is also generated. The code is generated 
fi-om a formal description of the objects that is compact, easy to edit, read and maintain. With this 

15 approach, the desaiption of the data model is independent fix)m any implementation. That 
description is used plus meta-data 18, 20, 22 regarding the type specific binding information to 
generate all code needed for representation in the needed type system and any conversion betwerai 
them. As shown in Fig. 1, the code generation involves the model 10 augmented by the type 
specific bindings 18, 20, 22. At runtime, the generated code is used to realize the type conversion 

2 0 24, 26, 28 from one type to another. 

Because XML is used to describe the model 10 and the meta-data 18, 20, 22, it is possible 
to author it directly as well as generate it partially or completely from another existing description. 
Typically a model is described using UML and is authored in a tool like Rational Rose. With the 
2 5 information obtained from the high level description of the model exported fix)m Rational Rose (as 
XMI) the XML description for the model is generated. 

The invention is based on the following inputs: 
- the description of the model; 
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- the binding information for the objects of the model between the different type systems; 

- the graphs that describe the relationships between the objects; 

- the type conversion information that describes how to convert a non-primitive type to a 
string. All are combined in one XML input file that contains all the information needed by 
the invention in order to generate the code. 

The use of the invention can be seen as a two step process, the steps being completely 
indepradent. The first step is to produce the XML input file for a given set of objects. Figures 2 and 
3 show how the XML file 40 (called XIDL.xml file) is typically produced fi-om a model 1 0 described 
in Rational Rose. The second step is to run the code generators to produce the Java code that allows 
the use of the objects of the model and do the type conversions. 

1, Producing XIDL File from Modfel 

The XIDL input file is generated as follows and as shown in Fig. 2 and Fig. 3. A model 30 
is first gaierated in Rational Rose 8 or other visual modelling tool in mdl format. The model 30 is 
then exported as an XMI file 32 using the XMI Alpha tool 32 (i.e. the IBM XMI toolkit from 
alphaWorks) or other tools that conform to the XMI format From the XMI file 34 an XSL 
transform automatically produces an XIDL input file that is the representation 10 of the model 30 
(using XIDL Generator 36). This file 10 is then updated, using the XIDL Constructor 46, with 
specific type-related information including the name bindings 1 8, 20, 22 between the model and the 
different types, and graphs that describe how to use the associations between the objects of the 
model. The XIDL Constructor 46 generates the XIDL.xml file 40 which is the input to the code 
generators. 

XIDL.dtd (the datatype definition of the XIDL format) 41 defines the XML vocabulary 

allowed in the XIDL input to the generator. The XIDL,xml file can be directly hand edited using 

aXMLeditororgeneratedfipomanothertool(asdescribed above). The XIDL file contains basically 
3 parts: 

I) Classes: These describe the model and the bindings between the model and Java, XML 
and SQL. 

CA9-2000-0064 o 
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2) Graphs: As the objects from the model have associations between each other, it is 
necessary to know which associations are relevant at one time in a given context. A graph 
describes for one object the subset of associations to follow to serialize (marshal) the object. 
Strictly speaking, a graph is in fact a sub-graph of the folly populated graph of associations 
found in the model for the object in question. The sub-graphs are needed in order to serialize 
an object to an XML message, as it is required to know which associated objects to include 
in the message. 



3) Type conversions : This part describes the custom helpers (fonctions in a progranmiing 
language) that handle non-primitive types. For instance, if one object contains an attribute 
Date, one converter is needed to convert the Date into a string and convert the resulting string 
back into a Date object. 

The following is a representative sample of an XIDL file: 
<XIDL> 
<ClassModel> 
<Classes> 

<Class name="ClassInfo" package="com.ibm.generationx.test.doc"> 
<Attribute name="courseId" type="int" visibility="private"> 
<InitialValue>0</InitialValue> 
</Attribute> 

<Association name="associatedPerson" type=" 
com.ibm.generationx.testdoc.Person"> 

<AssociationKeyMap foreign="id" local="personId7> 
</Association> 
</Class> 

<Class name="Person" padcage="com.ibm.generationx.test.doc"> 
<Attribute name="id" type="int*' visibility="private7> 
<Attribute name="name" type=" String" visibility="public"/> 

CA9-2000.0064 10 
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</Class> 
</Classes> 
<ClassBindings> 

<ClassBinding t>pe="c»m.ibm.generationx.test.doc.ClassInfo"> 
5 ? 

</CIassBinding> 
</ClassBindings> 
<;/ClassModel> 
<GraphModel> 
10 <Graphs> 

<Graph name="ClassInfoGraph" type=" 
com.ibm.generationx.test.doc.ClassInfo"> 
<Follow name="associatedPerson'7> 
</Graph> 
15 </Graphs> 

<GraphBmdings/> 
</GraphModel> 
</XIDL> 

20 2. Generating the Code 

The second step is to run the code generators to produce the Java code that allows the use of 
the objects of the model and to do the type conversions (Java 

<->XML, Java<->SQL, SQL<->XML) as shown in Figure 1 . The code produced by the invention 
provides the following functionality: 
2 5 - marshal objects from Java to XML; 

- marshal graphs of objects from Java to XML; 

- unmarshal objects from XML to Java; 

- unmarshal graphs of objects from XML to Java; 

- search, update, areate and delete objects from a database; 

CA9-2000-0064 n 
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- search, update, create and delete graphs of objects in one transaction 
from the database. 

From the self-contained XIDL file 40, called XIDL.xml, several code generators can be run 
to produce all the desired Java code. These are the XIDL DO Generator 42 and the XIDL Binding 
Generator 44. As shown in Fig. 4, for a class XYZ in the model 40, the code generatore 42, 44 
produce the following Java files: 



10 



15 



20 



25 



File name 
XYZjava 

XYZGenXBean.java 
XYZHome.java 

XYZKey.java 
XYZJava2XMLjava 
XYZXML2Java.java 
XYZ.PE 



Description 

The interface defining the getters and setters for all attributes 
and associations. 

The impl^entation of the above interface. 

The Java-RDB implementation allowing the object to be 
retrieved and persist. 

A helper defining the RDB key for the object 

A helper, used internally, that marshals from Java to XML. 

A helper, used internally, that unmarshals from XML to Java. 

An optional XML Parameter Entity defining the XYZ content 
model (::TODO::). 



In the graph section of the XIDL file, a graph defines which association to follow for an 
object when serializing it to XML. For a graph ABC in the Graphs section, the generator produces 
the following Java files: 

File name Description 

ABCJava2XML.java The helper that marshals fit)m Java to XML. 
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ABCXML2JAVA.java 



The helper that marshals from XML to Java. 



ABCRDBHelper.java 



A helper diat optimizes queries to the database. 



ABCdtd 



An interface defining the compound XML document, repre- 
senting ABC. 



Once the code has been generated, thra an Application program 50 can use the files for the 
intended application. 

The foregoing method therefore involves a) the definition of the XML that describes the 
model and the meta-data for the type binding; b) a generator that produces the XML describing the 
model from a description of a Model in Rational Rose (exported in XMI); and c) several code 
generators that produce Java code for doing type conversion between the different type systems. The 
method has an open architecture which allows new type systems to be added. This method has a 
number of advantages, including: a) it describes models in a type independent manner, simplifying 
support of multiple type systems and programming languages; b) integrates with common object 
modelling tools (e.g. Rational Rose) to allow simple authoring of these models; c) it is extensible 
to handle any kind of type system and type conversion; d) it handles type specific binding to provide 
flexibility; e) it uses graphs to describe messages based on 

objects of the model; f) facilitates reuse of objects in multiple messages; g) custom written code is 
not needed for the application software; h) there is more consistent generation of object code and 
faster generation of all objects; i) it allows optimization of the code in the future, for example, lazy 
initialization; and j) it allows retargeting the model for a different back end or application. 

The present system thus solves the conversion between any number of type systems, provides 
the definition of a complete description of the model and the binding information in one simple 
XML format, and supports inheritance at runtime and the use of graphs to create XML messages and 
optimizes database queries. 
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As will be apparent to those skilled in the art in the light of the foregoing disclosure, many 
alterations and modifications are possible in the practice of this invention without departing fiom 
the spirit or scope diereof Accordingly, the scope of the invCTtion is to be construed in accordance 
with the substance defined by the following claims. 
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The embodiments of the invention in which an exclusive propaty or privilege is claimed are defined 
as follows: 

1 • A computer-implemented method of generating serialization code for representing a model in a 
5 plurality of type systems, the method comprising the steps of: 

i) producing an input file firom said model for a given set of objects; 

ii) providing a code generator for acting on said input file to generate said serialization code. 

2. The method of claim 1 wherein said model is exported from a UML description. 

10 

3. The method of claim 1 or 2 wherein said model comprises a plurality of objects. 

4. The method of claim 1, 2 or 3 wherein said model is exported as an XMI file. 

15 5. The method of claim 1 , 2, 3 or 4 wherein said plurality of type systems comprises Java and SQL. 

6. The method of claim 1 , 2, 3, 4 or S wherein said input file is an XML file. 

7. The method of claim 1, 2» 3, 4, S or 6 wherein said input file comprises binding information 
2 0 between said model and said plurality of type systems. 

8. The method of claim 1, 2, 3, 4, 5, 6 or 7 wherein said input file comprises graphs that describe 
relationships between said objects of said model. 

25 9. The method of claims 1 , 2, 3, 4, S, 6, 7 or 8 wherein said input file comprises the type conversion 
information that describes how to convert a non-primitive type to a string. 



10. The method of claim 8 wherein said graphs describe for an object a subset of associations to 
follow to serialize the object. 
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1 1. The method of claim 6, 7, 8, 9 or 10 wherein said model is exported as an XMI file and said 
XML input file is produced from said XMI file by an XSL transform. 

12. The method of claim 1 wherein two code generators are provided for acting on said input file to 
generate said serialization code. 

13. The method of claim 12 wherein said two code generators are a binding generator and a DO 
generator. 

14. A method according to claim 1, fiirther comprising the step of: 

iii) using said serialization code in an application to carry out type conversion. 

1 5 . A data processing system for generating serialization code for representing a model in a plurality 
of type systems^ said data processing system comprising: 

i) means for producing an input file fiom said model for a given set of objects; and 

ii) means for providing a code generator for acting on said input file to generate said 
serialization code. 

16. A data processing system according to claim IS wherein said model is exported fix>m a UML 
description. 

1 7. A data processing system according to claim 1 S or 1 6 wherein said model comprises a plurality 
of objects. 

18. A data processing system according to claim IS, 16 or 17 wherein said model is exported as an 
XMI file. 

19. A data processing system according to claim 15, 16, 17 or 18 wherein said plurality of type 
systems comprises Java and SQL. 
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20. A data processing system according to claim 15, 16, 17, 18 or 19 wherein said input file is an 
XML file, 

21. A data processing system according to claim 15, 16, 17, 18, 19 or 20 wherein said input file 
5 comprises binding information between said model and said plurality of type systems. 

22. A data processing system according to claim 15, 16, 17, 18, 19, 20 or 21 \rtierein said input file 
comprises graphs that describe relationships between said objects. 

10 23. A data processing system according to claim 15, 16, 17, 18, 19,20,21 or 22 wherein said input 
file comprises the type conversion information that describes how to convert a non-primitive type 
to a string. 

24. A data processing system according to claim 23 wherein said graphs describe for an object a 
1 5 subset of associations to follow to serialize the object. 

25. A data processing system according to claun 20, 2 1 , 22 or 23 wherein said model is exported as 
an XMI file and said XML input file is produced from said XMI file by an XSL transform. 

20 26. A data processing system according to claim 15 wherein two code genwators are provided for 
acting on said input file to generate said serialization code. 

27. A data processing system according to claim 26 wherein said two code generators are a binding 
generator and a DO generator. 

25 

28. A data processing system according to claim 1, fiirtfaer comprising: 

iii) means for using said serialization code in an application to carry out type conversion. 
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29. A computer program product for generating serialization code for representing a model in a 
plurality of type systems, said computer program product comprising: 

a computer usable medium having computer readable program code means embodied in said 
medium for producing an input file from said model for a given set of objects; and 
said computer usable mediimi having computer readable program code means embodied in 
said medium for providing a code generator for acting on said ixxpui file to generate said 
serialization code. 

30. A computer program product according to claim 29 wherein said model is exported from a UML 
description as an XMI file and wherein said model comprises a plurality of objects, and wherein said 
input file is an XML file, fiirther comprising computer readable program code means embodied in 
said medium for producing said input file from: 

i) binding information between said model and said plurality of type systems; 

ii) graphs that describe relationships between said objects; and 

iii) type conversion information that describes how to convert a non-primitive type to a 
string. 

3 1 . A computer program product according to claim 29 or 30 wherein said plurality of type systems 
comprises Java and SQL. 

32. An article comprising: 

a computer readable modulated carrier signal; 

means embedded in said signal for producing an input file from said model for a given set 
of objects; and 

means embedded in said signal for providing a code generator for acting on said input file 
to generate serialization code. 
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33. A computer-implaiiented method of generating a model description from a description of a 
model in XMI comprising a plurality of objects which is useful for generating serialization code for 
representing a model in a plurality of type systems, comprising producing an input file comprising: 

i) binding information between said model and said plurality of type systems; 

ii) graphs that describe relationships between said objects; and 

iii) type convarsion information that describes how to convert a non-primitive type to a 
string. 
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